Clockpop 2.7
A. Overview
1. In General
Press and Hold the trigger button (the datebook button initially). Clock will appear and stay until you release the button.

If the handheld was off when the datebook button was pressed, it will go back to sleep.




2. Installation
Install ClockPop.prc.  (You may also want to install ClockPop Skins.prc as well and some "XTERN" files.)  If you do not have a hackmaster-type application installed, install X-Master from the distribution.  THEN you must go to the hackmaster application (Hackmaster, TealMaster, EVPlugbase on X-Master) installed on your PDA and enable ClockPop (usually this means tapping a checkbox).  If you have trouble getting ClockPop recognized because some other hack seems to cover it, uncheck the other hack, then tax ClockPop then the other hack. (or try the reverse order)
B. Changes
1. Changes in 2.7
1. Fixed fatal error when there are more than 10 appointments on a given date.
2. Added CP-ToDos XTERN.
2. Changes in 2.6
1. Fixed TIME command to work properly with 24 hour settings. 
2. Various other minor code fixes.
3. Changes in 2.5
1. Many changes to fix bugs and machine specific issues.  In particular, appointment preferences and date position should work better now.

2. Changed power-off method, to avoid crashes on m50x series.  The old power-off method is undocumented and (now) deprecated.  However, the officially sanctioned method now used by ClockPop doesn't work on some Handspring models.  If you have this problem, install ClockPop Skins and Select the Handspring Power Off method.  (You can then delete ClockPop Skins, the change is made directly to ClockPop).
4. Changes in 2.4
1. Changed backlight and off code so that m505 backlight preserving utilities should function correctly. 

5. Changes in 2.3
1.  Appointments that begin with '[' character are also hidden.
2. Using ClockPop skins, you can move the date to the top (the title bar) and show up to 5 appointments (instead of 4)
3. Using ClockPop skins you can define "special appointments" and control the order in which different types of appointments are listed.
6. Changes in 2.2
1.  Fixed problem on Handspring Visor caused by Date display at bottom

2.  Timed appointments that begin with "(" are now ignored.

3.  Pen trigger now reflects skins.
7. Changes in 2.1
Date now shows at the bottom, title on displays day of week.
8. Changes in 2.0
1.  You can now change the content and appearance  of the two message areas, using ClockPop Skins. For example: this is a version of the skin I use:


The skins approach is extensible using XTERN functions.  Some pre-written XTERNs and instructions for writing more XTERNs are included in this distribution.  Requests to me to write XTERNs will be considered.  If they seem easy and I have time, I'll do it.

2.  You can now choose whether appointments which have no time should be flush right or aligned with the event.

3.  Appointment that begin with a "(" are ignored.

4.  An appointment now remains visible in ClockPop until the present time is later than its scheduled ENDING time. 

5.  Date now appears only in the title bar, not at the bottom.  This gave me room to show 4 appointments instead of 3.

C. Configuration
1. How: 
In Hackmaster, tap configuration box. In X-Master, select ClockPop then tap "Configure" button at bottom of screen. 



2. Options:
a) Trigger Button
Tap preferred trigger button. 
b) Delay 
Tap "+" or "-" button. Test. Repeat until you are happy. If you can't tap the button quickly enough to avoid popping the clock, start lengthening the delay and try again.
c) Day of week format 
Normally, the day of the week appears in the title bar using the full English name and in the date at the bottom the same way. Check the "Short (local lang.)" box to have the day appear in both places as a 3 character abbreviation in the local language.  (The long day name is in English.  You can teach ClockPop the long day names in your local language using ClockPop Skins.)
d) Backlight on waking
Turn on to have the Palm turn on the backlight when triggered from sleep. 
 (There have been two reports that this does not work with a Palm V running OS 3.5.2 and several reports that it does. I have no idea why.)
e) Battery Info
By Default, shows battery voltage and percentage in upper left corner. (The percentage is from the Palm OS and probably corresponds to the part of the Launcher batter that would be filled in.)

You can modify the message and font using ClockPop Skins.  If this box is not checked, the message area will be blank, regardless of what you've done in ClockPop Skins.
f) Memory Info
Shows free memory in upper right corner.  The free memory number should correspond to the one given by the Launcher.

You can modify the message and font using ClockPop Skins.  If this box is not checked, the message area will be blank, regardless of what you've done in ClockPop Skins.

g) Appointments
Shows (up to 4) appointments for today with starting times later than now.  If there is room, shows untimed appointments as well. 
h) Show Seconds
You can turn off the display of the seconds.
i) Pen Trigger
If checked, the clock will pop up while the stylus is resting in the upper left corner of the Graffiti writing area.  (Up from the "abc" area.)  If you have an "m" model with a clock icon there, you will need to tap slightly to the right of the icon.
j) Untimed Flush
If appointments is checked, this will determine whether untimed appointments are aligned with the data from timed appointment or appear flush with the left margin.
D. Formats:
1. Date 
Date will follow long date format preference as set in "Formats" panel. 
2. Time 
If Format preference panel is set to a 24-hour format, the time display will now show the corresponding 24 format. All 12-hour formats appear as 
in default (colon).
E. Seconds
The seconds are  (optionally) displayed at the far right after the time, in small font.  The count is accurate enough for most purposes but is subject to the whim of any Palm activity that needs to run.
F. Use
1. Install 
a) Load file onto device. 
b) Open HackMaster (or X-Master or TealMaster or EVPlugBase) and 
c) enable Clockpop by putting a check next to it
.
If you already have a version of Clockpop installed, you must disable it before attempting to install a new version. 
2. Trigger 
Tap and hold trigger button. (Datebook button by default) 
3. Removal 
First disable Clockpop in HackMaster or other hack controller.
G. ClockPop Skins
The ClockPop Skins program (included in the distribution) lets you modify ClockPop further.
H. Distribution
1. Status
c. S. Millman 2001,
(smillman@usa.net)
all rights reserved 
Freeware
2.  Bug reports
Please send to me at smillman@usa.net.  I'll fix bugs are I have time.  Same for changes or improvements. 

